Package client.teavm

Klasse ImportedApiSAB

java.lang.Object

client.teavm.ImportedApiSAB

Alle implementierten Schnittstellen:

IImportedApi

public final class ImportedApiSAB
extends Object
implements IImportedApi

SharedArrayBuffer (SAB)-based implementation of ImportedApi.

This class enables high-performance, zero-copy data exchange between a TeaVM Web Worker and the browser main thread. Large buffers for audio, video, and oscilloscope data are shared via ByteBuffer backed by SABs, and synchronization is achieved using atomic operations on a small control buffer.

Buffers

• Audio samples: Written by the worker and read by the main thread.
• Video pixels: Written by the worker and read by the main thread.
• Oscilloscope gauges: Each chip has a map of shared buffers for waveform and envelope data.

Control Buffer

A small Int32Array stores atomic flags for synchronization:

 jsControlBuffer[0] → SAMPLE_FLAG_INDEX (audio ready)
 jsControlBuffer[1] → FRAME_FLAG_INDEX  (video ready)
 jsControlBuffer[2+] → OSC0_FLAG_INDEX + sidNum (oscilloscope ready per SID)
 

Flag values:

• ImportedApiSAB.CONTROL.FLAGS.READY
• ImportedApiSAB.CONTROL.FLAGS.NOT_READY

Synchronization Protocol

1. Worker writes to a buffer and sets the corresponding flag to ImportedApiSAB.CONTROL.FLAGS.READY.
2. Main thread processes the buffer, resets the flag to ImportedApiSAB.CONTROL.FLAGS.NOT_READY, and notifies the worker.
3. Worker waits using Atomics.wait(org.teavm.jso.typedarrays.Int32Array, int, int) until the flag is cleared, then continues.

This approach ensures efficient handshaking for real-time audio/video and oscilloscope data without copying large arrays.

Note: Currently, SABs are used for audio samples, video frames, and oscilloscope gauges only.

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static class	ImportedApiSAB.CONTROL

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
private org.teavm.jso.typedarrays.Int32Array	jsControlBuffer
private List<Map<String,org.teavm.jso.typedarrays.Int8Array>>	jsGaugeBuffersByChipNum
private org.teavm.jso.typedarrays.Uint8Array	jsPixelBuffer
private org.teavm.jso.typedarrays.Int8Array	jsSampleBuffer
private static final String	MODULE_NAME
private static final int	WAIT_TIMEOUT

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
ImportedApiSAB()

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	initControlBuffer()
ByteBuffer	initGaugeBuffer(String type, int chipNum, int pathLength)
ByteBuffer	initPixelBuffer(int maxWidth, int maxHeight)
ByteBuffer	initSampleBuffer(int chunkFrames, int channels)
void	processOsc(int sidNum, ByteBuffer wav0, String wav0Txt, ByteBuffer wav1, String wav1Txt, ByteBuffer wav2, String wav2Txt, ByteBuffer env0, String env0Txt, ByteBuffer env1, String env1Txt, ByteBuffer env2, String env2Txt, ByteBuffer fre0, String frq0Txt, ByteBuffer frq1, String frq1Txt, ByteBuffer frq2, String frq2Txt, ByteBuffer vol, String volTxt, ByteBuffer res, String resTxt, ByteBuffer fil, String filTxt)
void	processPixels(ByteBuffer pixelBuffer)
void	processPrinter(IPaper.Outputs output)
static void	processPrinterJS(String op)
void	processSamples(ByteBuffer sampleBuffer, float[] lookupTable)
void	processSidWrite(long absTime, int relTime, int addr, int value)
static void	processSidWriteJS(double at, int ti, int ad, int va)
void	processTimerEnd(double end)
static void	processTimerEndJS(double ed)
void	whatsSid(byte[] array)
static void	whatsSidJS(byte[] ar, int le)

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Felddetails

MODULE_NAME

private static final String MODULE_NAME

Siehe auch:

• Konstantenfeldwerte

WAIT_TIMEOUT

private static final int WAIT_TIMEOUT

Siehe auch:

• Konstantenfeldwerte

jsControlBuffer

private org.teavm.jso.typedarrays.Int32Array jsControlBuffer

jsSampleBuffer

private org.teavm.jso.typedarrays.Int8Array jsSampleBuffer

jsPixelBuffer

private org.teavm.jso.typedarrays.Uint8Array jsPixelBuffer

jsGaugeBuffersByChipNum

private List<Map<String,org.teavm.jso.typedarrays.Int8Array>> jsGaugeBuffersByChipNum

Konstruktordetails

ImportedApiSAB

public ImportedApiSAB()

Methodendetails

initControlBuffer

public void initControlBuffer()

Angegeben von:

initControlBuffer in Schnittstelle IImportedApi

initSampleBuffer

public ByteBuffer initSampleBuffer(int chunkFrames,
 int channels)

Angegeben von:

initSampleBuffer in Schnittstelle IImportedApi

initPixelBuffer

public ByteBuffer initPixelBuffer(int maxWidth,
 int maxHeight)

Angegeben von:

initPixelBuffer in Schnittstelle IImportedApi

initGaugeBuffer

public ByteBuffer initGaugeBuffer(String type,
 int chipNum,
 int pathLength)

Angegeben von:

initGaugeBuffer in Schnittstelle IImportedApi

processSamples

public void processSamples(ByteBuffer sampleBuffer,
 float[] lookupTable)

Angegeben von:

processSamples in Schnittstelle IImportedApi

processPixels

public void processPixels(ByteBuffer pixelBuffer)

Angegeben von:

processPixels in Schnittstelle IImportedApi

processOsc

public void processOsc(int sidNum,
 ByteBuffer wav0,
 String wav0Txt,
 ByteBuffer wav1,
 String wav1Txt,
 ByteBuffer wav2,
 String wav2Txt,
 ByteBuffer env0,
 String env0Txt,
 ByteBuffer env1,
 String env1Txt,
 ByteBuffer env2,
 String env2Txt,
 ByteBuffer fre0,
 String frq0Txt,
 ByteBuffer frq1,
 String frq1Txt,
 ByteBuffer frq2,
 String frq2Txt,
 ByteBuffer vol,
 String volTxt,
 ByteBuffer res,
 String resTxt,
 ByteBuffer fil,
 String filTxt)

Angegeben von:

processOsc in Schnittstelle IImportedApi

processSidWrite

public void processSidWrite(long absTime,
 int relTime,
 int addr,
 int value)

Angegeben von:

processSidWrite in Schnittstelle IImportedApi

processTimerEnd

public void processTimerEnd(double end)

Angegeben von:

processTimerEnd in Schnittstelle IImportedApi

processPrinter

public void processPrinter(IPaper.Outputs output)

Angegeben von:

processPrinter in Schnittstelle IImportedApi

whatsSid

public void whatsSid(byte[] array)

Angegeben von:

whatsSid in Schnittstelle IImportedApi

processSidWriteJS

public static void processSidWriteJS(double at,
 int ti,
 int ad,
 int va)

processTimerEndJS

public static void processTimerEndJS(double ed)

processPrinterJS

public static void processPrinterJS(String op)

whatsSidJS

public static void whatsSidJS(byte[] ar,
 int le)